<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Strict//EN">
<html>
<head>

  <meta http-equiv="Content-Language" content="en-us">



  <title>IupGLVal</title>
  <link rel="stylesheet" type="text/css" href="../../style.css">

  <style orientation="text/css">
.style1 {
	font-size: large;
}
  </style>
</head>


<body>

<div id="navigation">
  
<ul>

    <li><a href="#Creation">Creation</a></li>

    <li><a href="#Attributes">Attributes</a></li>

    <li><a href="#Callbacks">Callbacks</a></li>

    <li><a href="#Notes">Notes</a></li>

    <li><a href="#Examples">Examples</a></li>

    <li><a href="#SeeAlso">See Also</a></li>

  
</ul>

</div>


<h2>IupGLVal<span class="style1"> (since 3.11)</span></h2>

<p>Creates an embedded OpenGL Valuator control. Selects a value in a limited 
interval. It inherits from <a href="iupglsubcanvas.html">IupGLSubCanvas</a>. It 
exists only inside an
<a href="iupglcanvasbox.html">IupGLCanvasBox</a>.</p>

<h3><a name="Creation">Creation</a></h3>

<div>
  
<pre>Ihandle* IupGLVal(const char *<strong>orientation</strong>); [in C]<br>iup.glval{<strong>orientation</strong>: string} -&gt; (<strong>elem</strong>: ihandle) [in Lua]<br>glval(<strong>orientation</strong>) [in LED] </pre>

</div>

<p><strong>orientation</strong>: optional orientation of valuator. Can be NULL. See ORIENTATION 
attribute.</p>

  
<p>
  <u>Returns:</u> the identifier of the 
  created element, or NULL if an error occurs.</p>


<h3><a name="Attributes">Attributes</a></h3>



<p>The 
  <strong>IupGLVal</strong> element handle all attributes defined for a
<a href="iupglsubcanvas.html">IupGLSubCanvas</a> control.</p>
<blockquote>
  <hr>
</blockquote>


  <p><strong>BACKIMAGE</strong> (<font SIZE="3">non inheritable</font>):
  image name to be used as background.&nbsp; It will be zoomed to fill the 
  background (it does not includes the border). Use
	<a href="../func/iupsethandle.html">IupSetHandle</a> or
	<a href="../func/iupsetattributehandle.html">IupSetAttributeHandle</a> to 
	associate an image to a name. See also
	<a href="../elem/iupimage.html">IupImage</a>. IMPORTANT: for the slider match the 
  handler movement area the backimage must has a transparent space that will 
  have room for the handler, in the extremes this space should be at least half 
  the handler size.&nbsp; (since 3.11.2)</p>
<p><strong>BACKIMAGEHIGHLIGHT</strong> (<font SIZE="3">non inheritable</font>): 
background image name of the element in highlight state. If it is not defined 
then the BACKIMAGE is used. (since 3.11.2)</p>
  <p><strong>BACKIMAGEINACTIVE</strong> (<font SIZE="3">non inheritable</font>): 
  background image name of the element when inactive. If it is not defined then the 
  BACKIMAGE 
  is used and its colors will be replaced by a modified version creating the 
  disabled effect. (since 3.11.2)</p>

  
<p><strong>BACKIMAGEPRESS </strong>(<font size="3">non inheritable</font>): 
background image 
name of the element in pressed state. If it is not defined then the BACKIMAGE is 
used. (since 3.11.2)</p>


<p><a href="../attrib/iup_fgcolor.html">FGCOLOR</a>: Controls the bar color. Can 
have an alpha component. Default: &quot;200 225 245&quot;.</p>
<p><strong>FITTOBACKIMAGE</strong> (<font size="3">non inheritable</font>): 
enable the natural size to be computed from the BACKIMAGE. If BACKIMAGE is not 
defined will be ignored. When set to Yes it will set BORDERWIDTH to 0. Can be 
Yes or No. Default: No.&nbsp; (since 3.11.2)</p>
<p><strong>HANDLERSIZE</strong> (<font size="3">non inheritable</font>): handler 
size in the same direction of the ORIENTATION. Default: 0. If set to 0 it 
will be calculated with half of the dimension opposite to the ORIENTATION. If 
IMAGE is used, it will be ignored (since 3.11.2). When IMAGE is not 
used the handler size in the opposite direction is the size of the element.</p>
<p><strong>HLCOLOR</strong>: color used to indicate a highlight state. Can have 
an alpha component. Default: &quot;190 210 230&quot;.</p>


  <p><strong>IMAGE</strong> (<font SIZE="3">non inheritable</font>):
  Image name for the handler. Use
	<a href="../func/iupsethandle.html">IupSetHandle</a> or
	<a href="../func/iupsetattributehandle.html">IupSetAttributeHandle</a> to 
	associate an image to a name. See also
	<a href="../elem/iupimage.html">IupImage</a>. If defined the handler will be 
  replaced by the image.</p>
<p><strong>IMAGEHIGHLIGHT</strong> (<font SIZE="3">non inheritable</font>): 
Image name of the element in highlight state. If it is not defined then the 
IMAGE is used.</p>
  <p><strong>IMAGEINACTIVE</strong> (<font SIZE="3">non inheritable</font>): 
  Image name of the element when inactive. If it is not defined then the IMAGE 
  is used and its colors will be replaced by a modified version creating the 
  disabled effect. </p>

  
<p><strong>IMAGEPRESS </strong>(<font size="3">non inheritable</font>): Image 
name of the element in pressed state. If it is not defined then the IMAGE is 
used.</p>

<p><strong>MAX</strong>:
  Contains the maximum valuator value. Default 
  is 
  "1". When changed the display will not be updated until VALUE is 
set.</p>

<p><strong>MIN</strong>:
  Contains the minimum valuator value. Default 
  is "0". When changed the display will not be updated until VALUE is 
set.</p>



<p><strong>ORIENTATION </strong>(<font size="3">non inheritable</font>):&nbsp; Informs whether the valuator is "VERTICAL" 
  or "HORIZONTAL". 
  Vertical valuators are bottom to up, and horizontal valuators are left to right variations of min to max. 
Default: "HORIZONTAL".</p>
<p><strong>SLIDERSIZE </strong>(<font size="3">non inheritable</font>): slider 
size in the same direction of the ORIENTATION. Default: 5. Ignored when 
BACKIMAGE is used.</p>

<p><strong>VALUE </strong>(<font size="3">non inheritable</font>):
  Contains a number between MIN and MAX, indicating the valuator position. 
Default: "0.0".</p>

<h3><a name="Callbacks">Callbacks</a></h3>


<p>The 
  <strong>IupGLVal</strong> element handle all callbacks defined for the
<strong>IupGLSubCanvas</strong> control.</p>
<blockquote>
  <hr>
</blockquote>


<p><strong>VALUECHANGED_CB</strong>:
  Called after the value was interactively changed by the user.</p>

<pre>int function(Ihandle *<strong>ih</strong>); [in C]<br><strong>elem</strong>:valuechanged_cb() -&gt; (<strong>ret</strong>: number) [in Lua]</pre>

    
<p class="info"><strong>ih</strong>:
  identifier of the element that activated the 
  event.</p>


<p><strong>VALUECHANGING_CB</strong>:
  Called when the value starts or ends to be interactively changed by the user.</p>

<pre>int function(Ihandle *<strong>ih</strong>, int <strong>start</strong>); [in C]<br><strong>elem</strong>:valuechanging_cb(<strong>start</strong>: number) -&gt; (<strong>ret</strong>: number) [in Lua]</pre>

    
<p class="info"><strong>ih</strong>:
  identifier of the element that activated the 
  event.<br><strong>start</strong>: flag that indicates if the value started to 
be changed (1) or the change just ended (0).</p>

<h3><a name="Notes">Notes</a></h3>


<p>The natural size is the height of one character in one direction and the 
width of 15 characters in the other.</p>


</body>
</html>
